home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / r1_1mgr.zip / MANUAL.DOC next >
Text File  |  1990-10-15  |  41KB  |  895 lines
  1.  
  2.  
  3.           RBBS Manager Ver 1.0                                 1
  4.  
  5.  
  6.           
  7.           
  8.           
  9.           RBBS Manager Version 1.0
  10.           Copyright 1989,1990
  11.           by Charles Arden Brill
  12.           
  13.           
  14.           For Management of Various RBBS Functions in an integrated
  15.           menu-driven environment.
  16.           
  17.           
  18.           RBBS Manager is released as Shareware. Information provided later
  19.           in this document.
  20.           
  21.           
  22.           RBBS Manager is easy to set up.  It is a single executable file
  23.           that will create several files on your hard disk as necessary.
  24.           It will work from any drive or directory, however, it is
  25.           suggested that RBBS Manager be put in the same directory as your
  26.           FMS files.  This is preferably a subdirectory of the main board
  27.           eg; C:\RBBS\DIR.
  28.           
  29.           While the file size of RBBS-MGR is a hefty 200,000+ bytes it will
  30.           NOT function after any exe compression utility is applied to the
  31.           file, nor is it allowed to be renamed.  With the proliferation of
  32.           hard disks, and in view of the functions provided by RBBS-MGR,
  33.           this should not be a concern.
  34.           
  35.           The RBBS-MGR program requires you have all the RBBS files on
  36.           disk.  These include:
  37.           
  38.           Messages
  39.           Callers                      These files MUST be on disk.
  40.           Users                   Whether you use them or not, you must
  41.           Comments                at least create a zero byte file for
  42.           FMS directory                RBBS-MGR to take a look at.
  43.           Category Code file
  44.           
  45.           RBBS-MGR would also like all the memory you can give it.  The
  46.           amount above program size is dependent on the size of your FMS.
  47.           It may be run (does run quite successfully) in a multitasking
  48.           window. It is not as yet an 'aware' program. See future
  49.           enhancements.
  50.           
  51.           RBBS Manager provides functions that will allow you:
  52.           to view and delete messages
  53.           view and search callers file
  54.           view and search comments
  55.           view, search and edit users
  56.           view category code
  57.           view any zip file
  58.           view any text file
  59.           add, delete, move any FMS entry
  60.               insert or append in date or alpha order
  61.               shunt new fms entry to any file for append
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.           RBBS Manager Ver 1.0                                 2
  70.  
  71.  
  72.               search for text in fms
  73.               view zip from fms
  74.               reformat fms
  75.               check fms against disk directories
  76.               make a downloadable text file
  77.               correct date and size errors
  78.           retain different configs for subboards and nodes
  79.           
  80.           
  81.           As you can see RBBS Manager is rather fully functioned.  It is
  82.           intended as a tool for sysops to maintain their RBBS systems from
  83.           a single program as much as possible.
  84.           
  85.           Now I know you don't need to be told how to use the program,
  86.           however the following documentation is provided for reference.
  87.           
  88.           
  89.           
  90.           GENERAL CONSIDERATIONS
  91.           
  92.           RBBS Manager is heavily supportive of FMS functions because there
  93.           are a few sysops out there that still feel they should have some
  94.           knowledge of what files are being included on their board.  It is
  95.           true that RBBS allows almost complete automation of the File
  96.           system, this can be both a great boon or it can create problems.
  97.           RBBS-MGR allows an easy to use option, at the same time providing
  98.           an alternative, as close to an automated way of maintaining an
  99.           alphabetizing your FMS as possible.
  100.           
  101.           It is the feeling of the author that an alphabetized directory is
  102.           much friendlier for the average user.  Date ordered directories
  103.           are great for sysops or 'power users' but the normal caller
  104.           looking for a file has to wade through a lot of chaff.  It also
  105.           just appears more professional.
  106.           
  107.           The program is also designed be a monitor for board activity
  108.           without having the sysop Log on.  While running in a multitasking
  109.           window or network environment or even as a standalone, the
  110.           program services Callers, Comments, Messaging and Users.  As an
  111.           example, the program will announce any new comments that have
  112.           been added since it was last run.  It will also allow the sysop
  113.           to view messages without flagging them as received.
  114.           
  115.           The ability to load different config files increases the function
  116.           of RBBS_MGR dramatically.  It is possible to apply all of
  117.           RBBS-MGR's options to your different RBBS config files and paths.
  118.           So if you choose to keep a separate subboard for games you can
  119.           create a GAME-MGR.CFG file will all the appropriate paths and
  120.           settings and use all of RBBS managers features.
  121.           
  122.           The TOOLS are provide to maintain your FMS directories.  Most are
  123.           available from other sources and the author freely admits these
  124.           programs are perhaps faster.  Some speed has been sacrificed for
  125.           the user interface and because its just plain more enjoyable to
  126.           watch what's going on.  Also you will find the reporting more
  127.           complete than is found in most standalone 'quick' utilities.
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.           RBBS Manager Ver 1.0                                 3
  136.  
  137.  
  138.           
  139.           KEYING in RBBS Manager generally follows the common usage of pull
  140.           down menuing systems.  Menu selections are made with the cursor
  141.           arrows and an <ENTER>; or the command letters (Highlighted Menu
  142.           Letters) may be accessed by the <Alt>-<key> combination. An
  143.           important key combination to remember is <ALT>-<C> which will
  144.           clear any editing field.  Keying for each section is explained
  145.           specifically in each section description.
  146.           
  147.           Messages and Box prompts are removed by pressing the space bar or
  148.           enter key.  Prompts are accepted with <ENTER> or the appropriate
  149.           keying, usually displayed.  <ESC> is used to exit a function
  150.           without change (cancel).
  151.           
  152.           Some Menu Selections are not available throughout the entire
  153.           program.  These selections are 'turned off' until you enter the
  154.           appropriate section, then they magically appear and function, and
  155.           function well we hope.
  156.           
  157.           
  158.           
  159.           MENU AND STATUS LINES:
  160.           
  161.           The Menu Line stays at the top of your screen and includes all
  162.           the choices available to you while in various sections of RBBS
  163.           Manager.
  164.           The Status line resides at the bottom of your screen and displays
  165.           some useful information about what's going on.  CurrFile:, is the
  166.           currently loaded file you are working on, be it your FMS,
  167.           Messages, etc. To the right is a little status block with the
  168.           letters of the features you have turned on: eg; 43BZAN.  43 would
  169.           be the length of description, B - backups are toggled on, Z is
  170.           the first letter of your archive, A is the type of sort - either
  171.           A for alpha or D for date, N is whether you are running in a
  172.           shared environment - either Y or N.
  173.           To the left of the status block the amount of free memory you
  174.           have left is displayed.
  175.           The middle of Line 25 displays several messages that aren't too
  176.           cryptic.  FmsL - means your FMS is loaded, Sht - indicates you
  177.           have turned on the shunt file feature, etc.
  178.           
  179.           
  180.           
  181.           QUICK START
  182.           
  183.               For those allergic to Documentation there are a few points to
  184.           be aware of before you explore RBBS-MGR.  RBBS Manager checks
  185.           itself first and determines the video setup, loads the default
  186.           config, checks comments and then  decides its ok to turn control
  187.           over to you.  If you have not created the config file you will be
  188.           automatically taken to the setup.
  189.           
  190.           If the video determination doesn't meet your wishes you may force
  191.           RBBS Manager to display in black and white by calling the program
  192.           with the /B switch  eg: RBBS-MGR /B
  193.           
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.           RBBS Manager Ver 1.0                                 4
  202.  
  203.  
  204.           Setup first creates the default config.  This should include all
  205.           the path and setup information you need for the main RBBS.
  206.           SubBoards and node info, if different, may have there own config
  207.           files.
  208.           
  209.           ESC on any field aborts the setup program
  210.           
  211.           Default values for many fields are preloaded.  You may clear any
  212.           field with ALT-C.
  213.           
  214.           SETUP PROGRAM:
  215.           Name of Configuration File:  MUST be RBBS-MGR.CFG for the default
  216.           and is saved in the current  directory.
  217.           
  218.           Default extension for all Backup files: Default is .bak but if
  219.           you are using a utility like SWEEP and wish to change this to
  220.           .sav (or whatever) there is no problem.
  221.           
  222.           Make Automatic Backup:  RBBS Manager will make an automatic
  223.           backup file of your FMS before any action is performed, saved in
  224.           the current directory.  This allows you to turn this option off
  225.           if you like living on the edge.
  226.           
  227.           The Default Archive extension: Your archive of choice .zip, .pak,
  228.           .arc, etc.
  229.           
  230.           Default insertion mode:  RBBS Manager's FMS support allows
  231.           inserting files in the proper sorted order for your FMS
  232.           directories. You let the program know what order your default
  233.           directory will use.
  234.           NOTE:  RBBS Manager only supports sorting as per RBBS's default
  235.           bottom up sort.  If you have a /TOP sorted directory, it is
  236.           supported by RBBS-MGR but not in this released version. Contact
  237.           the author.
  238.           
  239.           Length of FMS Description field:  RBBS-MGR supports only 43 or 44
  240.           columns in the description field. This is an arbitrary choice by
  241.           the author.  No one has presented a compelling enough reason for
  242.           more or less columns.
  243.           NOTE: The reformat option off the Tools menu will easily reformat
  244.           your directory to the proper length.  It creates a new FMS you
  245.           can use in RBBS-MGR if you specify it in config.  After you are
  246.           assured that RBBS-MGR is for you you can rename it to your main
  247.           board FMS directory after deleting or renaming the original.
  248.           
  249.           Running in a File sharing Environment: Option tells RBBS Manager
  250.           to open files in a shared mode.  Generally needed only for
  251.           networks.
  252.           NOTE: Not required for DesqView@
  253.           
  254.           PATHNAMES: Config needs proper pathnames. Drive letter required
  255.           if not on default drive so for consistency just use the Drive
  256.           letter for all paths.
  257.           NOTE: With just a path entry RBBS-MGR only requires Drive and
  258.           path NO extra slashes  eg: C:\RBBS\UPLOADS is acceptable while
  259.           C:\RBBS\UPLOADS\ is NOT.
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.           RBBS Manager Ver 1.0                                 5
  268.  
  269.  
  270.           
  271.           Default values for many fields are preloaded.  You may clear any
  272.           field with ALT-C.
  273.           
  274.           Path to FMS Directory:  Your main FMS directory, it will be the
  275.           default every time RBBS-MGR is started.
  276.           
  277.           Category Code Path:  Path to the DIR.CAT file for the above FMS
  278.           directory.
  279.           
  280.           Path to RBBS Messages: Path to your main Message base
  281.           
  282.           Path to Callers: Path to your main board Callers file
  283.           
  284.           Path to Comments: Path to main board comment file.
  285.           NOTE: If you don't use a Comments file create one.  It doesn't
  286.           need to be used just on disk taking up space.
  287.           
  288.           Path to users:  Path to main board users file
  289.           
  290.           Path to Upload SubDir: Drive and directory path to Upload
  291.           directory.
  292.           
  293.           The DownLoad Directories (up to 22) are entered in the same
  294.           fashion as all other pathnames.  Esc on the next blank field will
  295.           terminate the entries.
  296.           NOTE: The list file support is not supported in this release,
  297.           however, the registered RBBS Manager supports this feature and
  298.           allows up to 99 different subdirectories.
  299.           
  300.           Provided you haven't made any glaring errors that the Setup
  301.           program couldn't catch you should be ready to run RBBS Manager.
  302.           Exit the program and restart to load the config or use the Config
  303.           menu and use the Load Config prompt to enter the default -
  304.           RBBS-MGR.CFG
  305.           
  306.           
  307.           
  308.           FILES MENU
  309.           
  310.           The files menu will be your launching pad to most of RBBS
  311.           Managers functions.  After the Setup has been properly completed
  312.           the files menu allows you too choose a section of your RBBS to
  313.           act upon.
  314.           
  315.           FMS ADD FILE:
  316.           Loads the Current FMS (as per Setup) and displays the add file
  317.           entry screen.  You may enter a filename for addition to your FMS
  318.           directory by using the fields provided.  <TAB> moves to next
  319.           field <Shift>-<Tab> returns to previous field.  Formatting is
  320.           provide for the size and date fields.  Enter the size in the
  321.           first position of the field and as you <Tab> out of the field it
  322.           will be right justified.  The date field also separates the
  323.           month, day and year.  The aim of the formatting is for you to
  324.           just <Tab> into the field and begin entering data without
  325.           worrying about the format.
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.           RBBS Manager Ver 1.0                                 6
  334.  
  335.  
  336.           The length of the Description field will match the 43 or 44
  337.           column choice from your Setup.
  338.           The Category code is not required (nothing is required past the
  339.           filename) so support for the old style directories hangs around.
  340.           Extended descriptions of up to five lines are accepted. <ESC> on
  341.           a blank description line accepts and exits the entry screen.
  342.           <Enter> on the first line of the extended descriptions also exits
  343.           if your entry has only a simple description.
  344.           The file entry is now ready for your choice of append or insert
  345.           off the Record Menu.
  346.           
  347.           FMS EDITOR:
  348.           This menu selection will also load the current FMS (as per your
  349.           Setup choice) or if it is previously loaded will move directly to
  350.           display the FMS Editor.  The Editor displays your chosen FMS
  351.           between the Menu line and the Status line.
  352.           The Cursor arrows are available to scroll a line at a time, PgUp,
  353.           PgDn move accordingly and Home and End keys are available.
  354.           The Status line displays the line currently highlighted by the
  355.           cursor.
  356.           From the editor the Edit, Search and View pull down menus are
  357.           available, each will be dealt with in its own section.
  358.           <Esc> removes the Editor.
  359.           
  360.           NEW FMS:
  361.           Choosing New FMS will allow you to change FMS directories without
  362.           leaving the RBBS-MGR.  After an message explaining what your
  363.           about to do you are asked to enter the new FMS.  If the new FMS
  364.           is NOT in the current directory you must enter the Full Pathname.
  365.           eg: D:\DIR\NEWFMS.DIR.  It will be loaded replacing the your
  366.           current file.
  367.           One note of caution, while this is a very handy feature, you must
  368.           remember that just loading the FMS retains the Config settings.
  369.           If you have both Alphabetical and Date directories and load an
  370.           alphabetical directory with a config using the DATE option you
  371.           will not be able to insert a new listing into the FMS.  Editing
  372.           and other features are not affected.
  373.           <ESC> at the prompts will abort the load.
  374.           
  375.           MESSAGE EDIT:
  376.           The default message file you have specified in the current Config
  377.           is loaded.  The Message section and sub menus are displayed.
  378.           They are explained later in this manual.
  379.           <ESC> returns to the main menus.
  380.           
  381.           USERS EDIT:
  382.           Much like the Message prompt, this will load the Users file
  383.           specified in the current Config. Users section and submenus are
  384.           explained later in the manual.
  385.           <ESC> returns to the main menu.
  386.           
  387.           RBBS DEF: is not available in this release
  388.           
  389.           CREATE FILE:
  390.           This will create a zero byte file that you name.  It has no
  391.           particular purpose.  Once in a while you may wish to create a
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.           RBBS Manager Ver 1.0                                 7
  400.  
  401.  
  402.           Configuration setup with special features.  Since RBBS Manager's
  403.           SetUp requires most files to be on disk you may want to use this
  404.           as a placeholder.  'C' wasn't used on the menu anyway...
  405.           
  406.           WRITE FILE:
  407.           This will write the current file(FMS) to disk, in effect a manual
  408.           save of your work up to this point.  Use this to save an FMS
  409.           before loading another one if changes have been made.
  410.           
  411.           UNLOAD CURRENT FILE:
  412.           Just the opposite of Write file. It will wipe the currently
  413.           loaded file(FMS), leaving nothing in memory.  For example, if you
  414.           are just checking your directories or searching and want to load
  415.           another FMS without any changes being made to the original, this
  416.           will clear the memory.
  417.           
  418.           EXIT SAVE:
  419.           Exits RBBS Manager and saves the current FMS to disk.
  420.           
  421.           EXIT:
  422.           Exits program without writing FMS.
  423.           
  424.           
  425.           
  426.           RECORD MENU
  427.           
  428.           The records menu is one of the menu selections not available in
  429.           all sections of RBBS Manager.  It allows selection of record
  430.           processing if you are in the FMS editor.It is activated only
  431.           after you have made an entry in the Add file screens and have
  432.           used <ESC> or the enter key on the first blank description line
  433.           to indicate you are through entering data.
  434.           
  435.           APPEND:
  436.           This choice will append the File Entry to the currently loaded
  437.           FMS.  In keeping with the RBBS default the filename will be
  438.           appended to the bottom of the FMS.
  439.           RBBS Manager in Insert Mode will only insert if the date is
  440.           inclusive, that is it falls between the range of dates in the
  441.           directory.  It it is equal or greater than the last date it must
  442.           be appended.
  443.           
  444.           INSERT:
  445.           Inserts the File Entry in its proper location in the FMS
  446.           directory, be it Date or Alphabetical ordering.  The display will
  447.           show the location of insertion by displaying several lines that
  448.           come before the insert location.  You are prompted to accept this
  449.           location.
  450.           You are notified if the date is not inclusive and asked to use
  451.           append.
  452.           Be aware also if you have chosen the Shunt option of the Config
  453.           Menu your shunt file is not inserted.  Shunt only appends.  Your
  454.           entry to the current FMS will be inserted regardless.
  455.           
  456.           RETURN WITH:
  457.           Ok, so you messed up? Got the Date is not Inclusive message? Well
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.           RBBS Manager Ver 1.0                                 8
  466.  
  467.  
  468.           if so or if you just changed your mind this will bring back the
  469.           File Add screen with your last Entry still waiting. You may then
  470.           proceed as normal.
  471.           This is also a useful function if you have a large number of
  472.           similar files to add.  You may keep returning with the file entry
  473.           and just change the fields necessary.  Saves some typing.
  474.           
  475.           CLEAR RETURN:
  476.           Along the same lines, if you start to add a file into your FMS
  477.           and change your mind for any reason this will clear the entry.
  478.           This is actually a holdover from a previous version of Manager.
  479.           In the Current version you shouldn't have to use this command
  480.           often if ever.
  481.           
  482.           NOTE:  RBBS Manager now uses the Clipboard as a buffer for the
  483.           file additions, so if you get confused as to what file you are
  484.           entering you may use the View Menu to view the clipboard. The
  485.           file to be entered will remain on the clipboard until another
  486.           entry is made or it is cleared with Clear Return.
  487.           
  488.           FORWARD:
  489.           Forward is not used in this release. (Message Forwarding)
  490.           
  491.           
  492.           
  493.           EDIT MENU
  494.           
  495.           The editor menu is on of the workhorses of RBBS Manager.  It is
  496.           available when you have loaded the FMS Editor are are preparing
  497.           to work on the FMS directory.  Most functions available from the
  498.           Editor menu key off the cursor line location. Some of the Main
  499.           pull down menus are used in the Editor. Record, Edit, Search, and
  500.           View all have functions available in the Editor.  These are
  501.           accessed the same way as if the Editor was not loaded with the
  502.           exception that you may not use the cursor arrows to move between
  503.           menus.  You must <ESC> each menu and re-enter another by using
  504.           the <ALT>-<letter> combination of that selection.
  505.           
  506.           LINE EDITOR:
  507.           This will highlight the Cursor line and allow individual editing
  508.           of that line. It is set to the line length you indicated in the
  509.           Setup and will not allow more characters to be included. Insert
  510.           or Overwrite mode is toggled by the insert key, however due to
  511.           the just mentioned safety feature if you need to insert a
  512.           character you must first delete or otherwise make sure the line
  513.           is not full.  <CTRL>-<right arrow> or <CTRL>-<left arrow> moves
  514.           by words.  The Line Editor starts in overwrite mode.
  515.           <ESC> or <ENTER> accepts the changes and returns you to the
  516.           cursor line.  Since you are only working on one line, changes
  517.           made are kept.  If you wish to cancel or revise your changes you
  518.           must use LineEdit and re-enter them.
  519.           
  520.           MARK BLOCK:
  521.           Marking the Block you want to process is the first thing needed
  522.           to take advantage of RBBS Managers moving, and deleting file
  523.           entries.  As other functions off this menu it keys off the cursor
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.           RBBS Manager Ver 1.0                                 9
  532.  
  533.  
  534.           line.  Choosing Mark block will highlight the cursor line.  The
  535.           down arrow is available to highlight up to five more lines
  536.           (coincidentally RBBS Manager supports up to five lines of
  537.           extended descriptions).
  538.           <Enter> accepts the highlighted lines for processing.
  539.           
  540.           INSERT:
  541.           This selection allows putting lines saved on the Clipboard into
  542.           the FMS directory.  The lines are Inserted below the cursor line.
  543.           Nothing is needed to accomplish this other than the proper use of
  544.           RBBS-MGR, in other words you don't have to make any space for the
  545.           additional lines it will be taken care of for you.
  546.           
  547.           DELETE:
  548.           Delete will remove the lines highlighted by Mark Block. This is
  549.           not reversible in this version so use judiciously.
  550.           
  551.           CLIPBOARD:
  552.           This hold the lines Highlighted by Mark Block. It is an
  553.           intermediate step while you position the cursor for insertion.
  554.           
  555.           FIELD CAPTURE: Not available in this release
  556.           
  557.           
  558.           
  559.           SEARCH MENU
  560.           
  561.           SEARCH:
  562.           This is rather self explanatory.  This release of the Manager
  563.           only supports searching the FMS directory loaded in the FMS
  564.           Editor section.   It will search for any string.  You will be
  565.           prompted for attention to case.
  566.           
  567.           REPEAT LAST FIND:
  568.           Continues search.
  569.           <ESC> aborts
  570.           
  571.           
  572.           
  573.           
  574.           VIEW MENU
  575.           
  576.           Another of the more frequently used functions of RBBS Manager.
  577.           These menus are available at most times in RBBS Manager.
  578.           
  579.           COMMENTS:
  580.           This will bring up a view window and display the contents of the
  581.           Comments as per SetUp. Keys available are the cursor arrows, home
  582.           and end keys.  This allows scanning the file for a particular
  583.           comment or skipping to the end to view the latest comments. You
  584.           will be notified of new comments, if any, upon the start of
  585.           RBBS-MGR.
  586.           <ESC> returns to the main pop up menus.
  587.           
  588.           CALLERS:
  589.           Choose this option and you are presented with a submenu.  The
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.           RBBS Manager Ver 1.0                                 10
  598.  
  599.  
  600.           Callers file may be listed based on these selections.  Some of
  601.           the submenus require input, such as the search on callers name.
  602.           The Callers file is read from disk and displayed in accordance
  603.           with your choice.  It is read as it is written, sequentially, and
  604.           as such provides little more than a direct scroll of your boards
  605.           activity.  This has proved adequate but is a candidate for
  606.           enhancement. Prompts should direct you through this section and
  607.           in general <ESC> gets you out.
  608.           
  609.           CATEGORY CODE:
  610.           Very nice feature if you have a tendency to forget the little
  611.           things.  Displays the DIR.CAT file, once again as per the SetUp.
  612.           It has been formatted for easier viewing.
  613.           <ALT>-<C> will perform a nifty maintenance function provided you
  614.           have an FMS loaded.  It will check the FMS directory against the
  615.           category codes in DIR.CAT and report on any file entries with
  616.           unrecognized codes.
  617.           
  618.           ZIPFILE:
  619.           Zipfile will show the files in any zipped archive.  If called
  620.           from the main menu section you must give a full path to the
  621.           archived file.  In the FMS Editor the function is quite a bit
  622.           easier to use.  The ZipViewer will use the file that the cursor
  623.           line highlights and automatically search the directories you have
  624.           entered in SetUp for the file.  If found in your download or
  625.           upload directories it will be displayed.
  626.           
  627.           ANYFILE:
  628.           Allows viewing of various files (text preferably).  Handy to view
  629.           batch files or the reports on disk that RBBS Manager generates.
  630.           You are prompted for a filename and path, and the cursor arrows,
  631.           home and end key are available for moving around in the file.
  632.           
  633.           
  634.           
  635.           
  636.           TOOLS MENU
  637.           
  638.           While at the main screen menus the only available selection of
  639.           the tools menu is the Dos Shell. All of the selections become
  640.           available once an FMS directory is loaded.
  641.           
  642.           RECONCILE FMS DSK/DIR:
  643.           If you are plagued by 'File not Found' errors in callers this can
  644.           help.  Also if you keep wondering where all your disk space went
  645.           and stumble across five copies of 'ListIt.now'.  Reconcile will
  646.           do just that, it compares the FMS file list to itself and to the
  647.           actual disk directories listed in SetUp.  It also checks those
  648.           directories against themselves for multiple file copies.  Most
  649.           importantly it reports where the multiples are located.
  650.           You are presented a prompt screen.  If you want RBBS Manager to
  651.           create an ASCII report (viewable by the View Menu's Anyfile
  652.           command) indicate it here.  Also if you have chained directories
  653.           RBBS-MGR will search up to Three(3) chained FMS's.
  654.           The first stage of Reconcile just checks for multiple filenames
  655.           in your FMS and multiple filenames in the Disk directories. The
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.           RBBS Manager Ver 1.0                                 11
  664.  
  665.  
  666.           status line gives an indicator of activity.  Running in a
  667.           multitasking window with large directories this isn't the
  668.           speediest procedure; while it is checking for multiple names
  669.           RBBS-MGR also sets up for the next search.
  670.           Upon completion you are prompted whether to cross check the FMS
  671.           against the Directories.  This provides the most useful report.
  672.           You will also be able to keep track on your monitor and the
  673.           status line indicator.  The Report file generated is named
  674.           FILECOMP.DAT.
  675.           
  676.           MAKE DOWNLOADABLE TEXT:
  677.           This choice creates an ASCII file on disk of your FMS directory
  678.           organized by category code and with the codes removed.  Or it
  679.           will create a single file for each code depending on how you
  680.           answer the prompt.  Once again RBBS Manager keeps you apprised of
  681.           the progress by watching the codes count down.  The ASCII file
  682.           will include all extended descriptions.
  683.           The header line is basically included to divide the categories,
  684.           you will no doubt want to customize this with your board name and
  685.           perhaps an explanation of the contents.
  686.           The file created by RBBS Manager is DOWNLOAD.FMS, when  multiple
  687.           files are selected the category code is used as the filename but
  688.           the first category retains the name DOWNLOAD.FMS.  The Extension
  689.           is always FMS.
  690.           
  691.           FORMAT/STRUCTURE FMS:
  692.           The purpose of this section is twofold.  A maintenance function
  693.           to check the proper format of your FMS or initially it will
  694.           reconstruct your FMS to the proper line length for RBBS Manager.
  695.           Used to check your FMS it will check each field for proper
  696.           location and size and check for line length.
  697.           RBBS used to allow some flexibility in the Date/Size fields so
  698.           the extra space option is present.  Take the default 'Y' and you
  699.           will have the two spaces between the fields, much better visually
  700.           than a single space.
  701.           It is a non-destructive check and it will write a file to disk
  702.           called NEWFORM.FMS  This file will have the character '!' in any
  703.           location found to be in error.  You search on the '!' character
  704.           to find any errors with confidence that even if they are there
  705.           the directory will have no display problems.
  706.           The non-destructive nature of the reformat isn't entirely fool
  707.           proof.  During the reformat and check RBBS Manager transfers the
  708.           REFORMATED lines into the FMS file stored in memory.  This is
  709.           handy in that it makes viewing any changes easier or for a first
  710.           time reformat it will make using the other functions of the
  711.           Manager possible.  If everything checks out you can just Exit
  712.           Save the FMS in memory and it will replace your old FMS still
  713.           keeping the old FMS as the backup (That is if you aren't one of
  714.           those living on the edge with the backup turned off).  If you do
  715.           not wish to save the reformated FMS just exit without writing the
  716.           file and you will still have the new version in NEWFORM.FMS on
  717.           disk.
  718.           During the process the line length is truncated to the length
  719.           assigned in SetUp.  If your previous line length was shorter, no
  720.           problem, as extra spaces are added to the description field.  If
  721.           it was longer you will lose spaces or text from the description
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.           RBBS Manager Ver 1.0                                 12
  730.  
  731.  
  732.           field.  No help for that, but it will be worth the change.
  733.           
  734.           DATE SIZE CHECK:
  735.           Checks the date and size listed in your FMS directory against the
  736.           actual disk date and size of the file in the download directories
  737.           from SetUp.
  738.           The first prompt you are presented with after choosing Date/Size
  739.           asks if you wish to be prompted for each file or to run
  740.           automatically.  If you are very conscientious you may want to try
  741.           the prompt but if being run for the first time it is possible you
  742.           will be there all night if you have a large directory.   The
  743.           manual [P]rompt stops for each file found that the FMS listing
  744.           doesn't correspond  to the disk directory entry and lets you
  745.           specify where to  write date and size, to the file or the disk.
  746.           While this sounds harmless enough if you have a date ordered
  747.           directory you will have to reorganize every file to its proper
  748.           location.
  749.           After choosing automatic (did we successfully talk you out of
  750.           [P]rompt?) RBBS Manager will proceed to check every file in the
  751.           currently loaded FMS against the disk directories.  As usual in
  752.           RBBS Manager you will be kept appraised of what's going on by the
  753.           display.
  754.           
  755.           IMPORT FORMATTED LINES:
  756.           Not available in this release.
  757.           
  758.           Shell to DOS:
  759.           Shells out to Dos if there is something you need to check. And as
  760.           long as your checking remember that if you have RBBS-MGR loaded
  761.           with an FMS you will not have much memory left to run anything
  762.           other than some of the more sensibly written programs with
  763.           smaller memory requirements.  Unload your FMS if you need more
  764.           memory.
  765.           
  766.           
  767.           
  768.           CONFIG MENU
  769.           
  770.           RUN SETUP:
  771.           For a detail account of the SetUp screens refer to the Quick
  772.           Start section of the Documents.  This must be run at least once
  773.           and you will probably run it several times because it creates the
  774.           RBBS-MGR configuration files.
  775.           The ability to have multiple configs is what gives RBBS Manager
  776.           such versatility.  All sorts of tricks are possible (and many
  777.           tips are included in the registered manual).
  778.           
  779.           LOAD NEWCFG:
  780.           This allows changing the config file that RBBS Manager relies
  781.           upon for all its file path information.
  782.           
  783.           BACKUP:
  784.           This is a toggle. Using  <ENTER> while the prompt is highlighted
  785.           toggles the RBBS_MGR Backup feature on and off. A check appears
  786.           if the option is on and it is indicated on the status line.
  787.           
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.           RBBS Manager Ver 1.0                                 13
  796.  
  797.  
  798.           INSERT MODE:
  799.           Also a Toggle.  Same procedure applies to toggle it on and off
  800.           however, the check will always be present with an 'a' or 'd'
  801.           behind it depending on whether you choose date or Alphabetical
  802.           ordered directories.  It is also indicated on the status line.
  803.           
  804.           SHUNT:
  805.           The shunt is the only Config  menu entry requiring input.  If you
  806.           select shunt you will need to provide a filename.  This may be
  807.           any filename, existing or not.  All new entries added with the
  808.           RBBS Managers insert or append features will be appended to the
  809.           shunt file.  A check will appear if active and you are notified
  810.           on the status line.
  811.           
  812.           
  813.           
  814.           FUTURE ENHANCEMENTS
  815.           
  816.           RBBS Manager is so full featured it is going to take care of all
  817.           your RBBS needs?  .....Not yet, and quite possible never, but
  818.           that doesn't mean we won't try.
  819.           Some of the next steps have been alluded to in the documentation
  820.           or for those of you who browsed the menus there are some prompts
  821.           you noticed aren't active yet.  RBBS Manager continues to evolve.
  822.           The first major change major change under testing is a decrease
  823.           in the memory requirements for the FMS.  This will allow loading
  824.           two separate FMS's in windows and allow entries to be moved, and
  825.           copied between them.
  826.           Programmers note: As RBBS Manager is written with MicroSoft PDS
  827.           7.0 the FMS has been loaded as an huge fixed string array which
  828.           requires the fixed string to be 128 bytes long.  Quite a bit of
  829.           wasted memory there.  So it was done quicker...Release 2 fixes
  830.           this and with the increase in memory available allows windowed
  831.           editing of more than one FMS.
  832.           Message Editing and Forwarding will be added to RBBS-MGR.  Only
  833.           between RBBS Conferences and SubBoards. No NetMail support is
  834.           planned (There's enough of those).
  835.           RBBS Manager will be written to specifically interface with
  836.           Desqview, using the Desqview API.
  837.           A host of other changes and yes, perhaps a bug fix or two.
  838.           Suggestions will be taken very seriously as there are as many
  839.           different RBBS configurations as RBBS's out there and maybe a
  840.           useful function to all has been totally overlooked.  ANY feedback
  841.           is appreciated.
  842.           
  843.           
  844.           
  845.           SHAREWARE
  846.           
  847.           There should be no need to explain the intricacies of ShareWare
  848.           to a sysop.  Also a plea is tiresome.  There are some distinct
  849.           advantages to registering RBBS Manager.  Bug fix releases are
  850.           free (distributed on 360K 5.25 inch floppies). Also the
  851.           registration package includes a more extensive manual, and for
  852.           the proliferation of processors (say that five times fast)
  853.           versions of the program are available to take advantage of the
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.           RBBS Manager Ver 1.0                                 14
  862.  
  863.  
  864.           286 and 386 CPU's.  Support is free via BBS or Voice (you receive
  865.           a voice number with the registration package). 'Nuff said.
  866.           Registration is 30.00.
  867.           Registration Address and Checks payable to:
  868.                    Charles Arden Brill
  869.                    4812 NE 103rd.
  870.                    Seattle, Wa 98125
  871.           No form is enclosed.  Break down and write a note with your Name
  872.           and Address. You might also give any impression or suggestion you
  873.           wish to pass along.
  874.           
  875.           SUPPORT BBS:
  876.           Support for RBBS Manager is available from the LETTERS RBBS (206)
  877.           524-4811. 24hrs 2400baud
  878.           
  879.           
  880.           RELEASE HISTORY
  881.           
  882.           Version 1.0:
  883.               Initial Release
  884.           
  885.           Version 1.1:
  886.               Fixed bug in Message edit and User edit submenus.  Varible
  887.               was not declared static resulting in improper display of
  888.               submenu after using certain functions off menu.
  889.               Fixed interesting error where FIXALL in the Reformat menu
  890.               actually messed things up.  Result of a section of code
  891.               remaining in the routine from a previous version thus varible
  892.               values were corrupt.
  893.           
  894.  
  895.